Node / meshtastic / Meshtastic-Android / files / core / data / src / commonMain / kotlin / org / meshtastic / core / data / repository / DeviceHardwareRepositoryImpl.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.data.repository

Tff7b72import T7ee787co.touchlab.kermit.Logger

Tff7b72import T7ee787kotlinx.coroutines.withContext

Tff7b72import T7ee787org.koin.core.annotation.Single

Tff7b72import T7ee787org.meshtastic.core.common.util.nowMillis

Tff7b72import T7ee787org.meshtastic.core.common.util.safeCatching

Tff7b72import T7ee787org.meshtastic.core.data.datasource.BootloaderOtaQuirksJsonDataSource

Tff7b72import T7ee787org.meshtastic.core.data.datasource.DeviceHardwareJsonDataSource

Tff7b72import T7ee787org.meshtastic.core.data.datasource.DeviceHardwareLocalDataSource

Tff7b72import T7ee787org.meshtastic.core.database.entity.DeviceHardwareEntity

Tff7b72import T7ee787org.meshtastic.core.database.entity.asExternalModel

Tff7b72import T7ee787org.meshtastic.core.di.CoroutineDispatchers

Tff7b72import T7ee787org.meshtastic.core.model.BootloaderOtaQuirk

Tff7b72import T7ee787org.meshtastic.core.model.DeviceHardware

Tff7b72import T7ee787org.meshtastic.core.model.util.TimeConstants

Tff7b72import T7ee787org.meshtastic.core.network.DeviceHardwareRemoteDataSource

Tff7b72import T7ee787org.meshtastic.core.repository.DeviceHardwareRepository

Tf0883e@Single

Tff7b72class T56d364DeviceHardwareRepositoryImplTb4b4b4(

Tff7b72private Tff7b72val Te6edf3remoteDataSourceTb4b4b4: Te6edf3DeviceHardwareRemoteDataSourceTb4b4b4,

Tff7b72private Tff7b72val Te6edf3localDataSourceTb4b4b4: Te6edf3DeviceHardwareLocalDataSourceTb4b4b4,

Tff7b72private Tff7b72val Te6edf3jsonDataSourceTb4b4b4: Te6edf3DeviceHardwareJsonDataSourceTb4b4b4,

Tff7b72private Tff7b72val Te6edf3bootloaderOtaQuirksJsonDataSourceTb4b4b4: Te6edf3BootloaderOtaQuirksJsonDataSourceTb4b4b4,

Tff7b72private Tff7b72val Te6edf3dispatchersTb4b4b4: Te6edf3CoroutineDispatchersTb4b4b4,

Tb4b4b4) Tb4b4b4: Te6edf3DeviceHardwareRepository Tb4b4b4{

T8b949e/**

* Retrieves device hardware information by its model ID and optional target string.

*

* Pipeline:

* 1. If the local DB is empty, seed it from the bundled JSON asset (instant baseline).

* 2. If the cached entry is stale or missing, refresh from the remote API.

* 3. Return the best available data from the DB.

*/

Tff7b72override Tff7b72suspend Tff7b72fun Td2a8ffgetDeviceHardwareByModelTb4b4b4(

Te6edf3hwModelTb4b4b4: Tffa657IntTb4b4b4,

Te6edf3targetTb4b4b4: Tffa657String?Tb4b4b4,

Te6edf3forceRefreshTb4b4b4: Tffa657BooleanTb4b4b4,

Tb4b4b4)Tb4b4b4: Te6edf3ResultTff7b72<Te6edf3DeviceHardware?Tff7b72> Tff7b72= Te6edf3withContextTb4b4b4(Te6edf3dispatchersTb4b4b4.Te6edf3ioTb4b4b4) Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3d Tb4b4b4{

Ta5d6ff"Ta5d6ffDeviceHardwareRepository: getDeviceHardwareByModel(hwModel=Tffd700$Te6edf3hwModelTa5d6ff,Ta5d6ff" Tff7b72+

Ta5d6ff"Ta5d6ff target=Tffd700$Te6edf3targetTa5d6ff, forceRefresh=Tffd700$Te6edf3forceRefreshTa5d6ff)Ta5d6ff"

Tb4b4b4}

Tff7b72val Te6edf3quirks Tff7b72= Te6edf3loadQuirksTb4b4b4(Tb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3forceRefreshTb4b4b4) Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3d Tb4b4b4{ Ta5d6ff"Ta5d6ffDeviceHardwareRepository: forceRefresh=true, clearing cacheTa5d6ff" Tb4b4b4}

Te6edf3localDataSourceTb4b4b4.Te6edf3deleteAllDeviceHardwareTb4b4b4(Tb4b4b4)

Tb4b4b4}

T8b949e// 1. Seed from bundled JSON if the DB is completely empty (first launch or post-wipe).

Tff7b72if Tb4b4b4(Tff7b72!Te6edf3localDataSourceTb4b4b4.Te6edf3hasAnyEntriesTb4b4b4(Tb4b4b4)Tb4b4b4) Tb4b4b4{

Te6edf3seedCacheFromBundledJsonTb4b4b4(Tb4b4b4)

Tb4b4b4}

T8b949e// 2. Check cache; refresh from network if stale, empty, or forced.

Tff7b72var Te6edf3entities Tff7b72= Te6edf3lookupEntitiesTb4b4b4(Te6edf3hwModelTb4b4b4, Te6edf3targetTb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3forceRefresh Tff7b72|Tff7b72| Te6edf3entitiesTb4b4b4.Te6edf3isEmptyTb4b4b4(Tb4b4b4) Tff7b72|Tff7b72| Te6edf3entitiesTb4b4b4.Te6edf3any Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3isStaleTb4b4b4(Tb4b4b4) Tb4b4b4}Tb4b4b4) Tb4b4b4{

Te6edf3refreshFromNetworkTb4b4b4(Tb4b4b4)

Te6edf3entities Tff7b72= Te6edf3lookupEntitiesTb4b4b4(Te6edf3hwModelTb4b4b4, Te6edf3targetTb4b4b4)

Tb4b4b4}

T8b949e// 3. Resolve and return the best available data.

Tff7b72val Te6edf3matched Tff7b72= Te6edf3disambiguateTb4b4b4(Te6edf3entitiesTb4b4b4, Te6edf3targetTb4b4b4)

Te6edf3ResultTb4b4b4.Te6edf3successTb4b4b4(Te6edf3applyBootloaderQuirkTb4b4b4(Te6edf3hwModelTb4b4b4, Te6edf3matchedTff7b72?.Te6edf3asExternalModelTb4b4b4(Tb4b4b4)Tb4b4b4, Te6edf3quirksTb4b4b4, Te6edf3targetTb4b4b4)Tb4b4b4)

Tb4b4b4}

T8b949e/** Looks up entities by hwModel, falling back to a target-only lookup when needed. */

Tff7b72private Tff7b72suspend Tff7b72fun Td2a8fflookupEntitiesTb4b4b4(Te6edf3hwModelTb4b4b4: Tffa657IntTb4b4b4, Te6edf3targetTb4b4b4: Tffa657String?Tb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Te6edf3DeviceHardwareEntityTff7b72> Tff7b72=

Te6edf3localDataSourceTb4b4b4.Te6edf3getByHwModelTb4b4b4(Te6edf3hwModelTb4b4b4)Tb4b4b4.Te6edf3ifEmpty Tb4b4b4{

Te6edf3targetTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3listOfNotNullTb4b4b4(Te6edf3localDataSourceTb4b4b4.Te6edf3getByTargetTb4b4b4(Tffa657itTb4b4b4)Tb4b4b4) Tb4b4b4} Tff7b72?: Te6edf3emptyListTb4b4b4(Tb4b4b4)

Tb4b4b4}

Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffseedCacheFromBundledJsonTb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3safeCatching Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3d Tb4b4b4{ Ta5d6ff"Ta5d6ffDeviceHardwareRepository: seeding cache from bundled JSONTa5d6ff" Tb4b4b4}

Tff7b72val Te6edf3jsonHardware Tff7b72= Te6edf3jsonDataSourceTb4b4b4.Te6edf3loadDeviceHardwareFromJsonAssetTb4b4b4(Tb4b4b4)

Te6edf3localDataSourceTb4b4b4.Te6edf3insertAllDeviceHardwareTb4b4b4(Te6edf3jsonHardwareTb4b4b4)

Tb4b4b4}

Tb4b4b4.Te6edf3onFailure Tb4b4b4{ Te6edf3e Tff7b72-Tff7b72> Te6edf3LoggerTb4b4b4.Te6edf3wTb4b4b4(Te6edf3eTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffDeviceHardwareRepository: failed to seed cache from bundled JSONTa5d6ff" Tb4b4b4} Tb4b4b4}

Tb4b4b4}

Tff7b72private Tff7b72suspend Tff7b72fun Td2a8ffrefreshFromNetworkTb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3safeCatching Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3d Tb4b4b4{ Ta5d6ff"Ta5d6ffDeviceHardwareRepository: fetching from remote APITa5d6ff" Tb4b4b4}

Tff7b72val Te6edf3remoteHardware Tff7b72= Te6edf3remoteDataSourceTb4b4b4.Te6edf3getAllDeviceHardwareTb4b4b4(Tb4b4b4)

Te6edf3LoggerTb4b4b4.Te6edf3d Tb4b4b4{ Ta5d6ff"Ta5d6ffDeviceHardwareRepository: remote returned Tffd700${Te6edf3remoteHardwareTb4b4b4.Te6edf3sizeTffd700}Ta5d6ff entriesTa5d6ff" Tb4b4b4}

Te6edf3localDataSourceTb4b4b4.Te6edf3insertAllDeviceHardwareTb4b4b4(Te6edf3remoteHardwareTb4b4b4)

Tb4b4b4}

Tb4b4b4.Te6edf3onFailure Tb4b4b4{ Te6edf3e Tff7b72-Tff7b72> Te6edf3LoggerTb4b4b4.Te6edf3wTb4b4b4(Te6edf3eTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffDeviceHardwareRepository: network refresh failedTa5d6ff" Tb4b4b4} Tb4b4b4}

Tb4b4b4}

Tff7b72private Tff7b72fun Td2a8ffdisambiguateTb4b4b4(Te6edf3entitiesTb4b4b4: Te6edf3ListTff7b72<Te6edf3DeviceHardwareEntityTff7b72>Tb4b4b4, Te6edf3targetTb4b4b4: Tffa657String?Tb4b4b4)Tb4b4b4: Te6edf3DeviceHardwareEntity? Tff7b72=

Tff7b72when Tb4b4b4(Te6edf3targetTb4b4b4) Tb4b4b4{

Tff7b72null Tff7b72-Tff7b72> Te6edf3entitiesTb4b4b4.Te6edf3firstOrNullTb4b4b4(Tb4b4b4)

Tff7b72else Tff7b72-Tff7b72>

Te6edf3entitiesTb4b4b4.Te6edf3find Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3platformioTarget Tff7b72=Tff7b72= Te6edf3target Tb4b4b4}

Tff7b72?: Te6edf3entitiesTb4b4b4.Te6edf3find Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3platformioTargetTb4b4b4.Te6edf3equalsTb4b4b4(Te6edf3targetTb4b4b4, Te6edf3ignoreCase Tff7b72= Tff7b72trueTb4b4b4) Tb4b4b4}

Tff7b72?: Te6edf3entitiesTb4b4b4.Te6edf3firstOrNullTb4b4b4(Tb4b4b4)

Tb4b4b4}

Tff7b72private Tff7b72fun Te6edf3DeviceHardwareEntityTb4b4b4.Td2a8ffisIncompleteTb4b4b4(Tb4b4b4)Tb4b4b4: Tffa657Boolean Tff7b72=

Te6edf3displayNameTb4b4b4.Te6edf3isBlankTb4b4b4(Tb4b4b4) Tff7b72|Tff7b72| Te6edf3platformioTargetTb4b4b4.Te6edf3isBlankTb4b4b4(Tb4b4b4) Tff7b72|Tff7b72| Te6edf3imagesTb4b4b4.Te6edf3isNullOrEmptyTb4b4b4(Tb4b4b4)

Tff7b72private Tff7b72fun Te6edf3DeviceHardwareEntityTb4b4b4.Td2a8ffisStaleTb4b4b4(Tb4b4b4)Tb4b4b4: Tffa657Boolean Tff7b72=

Te6edf3isIncompleteTb4b4b4(Tb4b4b4) Tff7b72|Tff7b72| Tb4b4b4(Te6edf3nowMillis Tff7b72- Tff7b72thisTb4b4b4.Te6edf3lastUpdatedTb4b4b4) Tff7b72> Te6edf3CACHE_EXPIRATION_TIME_MS

Tff7b72private Tff7b72fun Td2a8ffloadQuirksTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Te6edf3BootloaderOtaQuirkTff7b72> Tb4b4b4{

Tff7b72val Te6edf3quirks Tff7b72= Te6edf3bootloaderOtaQuirksJsonDataSourceTb4b4b4.Te6edf3loadBootloaderOtaQuirksFromJsonAssetTb4b4b4(Tb4b4b4)

Te6edf3LoggerTb4b4b4.Te6edf3d Tb4b4b4{ Ta5d6ff"Ta5d6ffDeviceHardwareRepository: loaded Tffd700${Te6edf3quirksTb4b4b4.Te6edf3sizeTffd700}Ta5d6ff bootloader quirksTa5d6ff" Tb4b4b4}

Tff7b72return Te6edf3quirks

Tb4b4b4}

Tff7b72private Tff7b72fun Td2a8ffapplyBootloaderQuirkTb4b4b4(

Te6edf3hwModelTb4b4b4: Tffa657IntTb4b4b4,

Te6edf3baseTb4b4b4: Te6edf3DeviceHardware?Tb4b4b4,

Te6edf3quirksTb4b4b4: Te6edf3ListTff7b72<Te6edf3BootloaderOtaQuirkTff7b72>Tb4b4b4,

Te6edf3reportedTargetTb4b4b4: Tffa657String? Tff7b72= Tff7b72nullTb4b4b4,

Tb4b4b4)Tb4b4b4: Te6edf3DeviceHardware? Tff7b72= Te6edf3baseTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3hw Tff7b72-Tff7b72>

Tff7b72val Te6edf3matchedQuirk Tff7b72= Te6edf3quirksTb4b4b4.Te6edf3firstOrNull Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3hwModel Tff7b72=Tff7b72= Te6edf3hwModel Tb4b4b4}

Tff7b72val Te6edf3withQuirk Tff7b72=

Tff7b72if Tb4b4b4(Te6edf3matchedQuirk Tff7b72!Tff7b72= Tff7b72nullTb4b4b4) Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3d Tb4b4b4{

Ta5d6ff"Ta5d6ffDeviceHardwareRepository: applying quirk: Ta5d6ff" Tff7b72+

Ta5d6ff"Ta5d6ffrequiresBootloaderUpgradeForOta=Tffd700${Te6edf3matchedQuirkTb4b4b4.Te6edf3requiresBootloaderUpgradeForOtaTffd700}Ta5d6ff, Ta5d6ff" Tff7b72+

Ta5d6ff"Ta5d6ffinfoUrl=Tffd700${Te6edf3matchedQuirkTb4b4b4.Te6edf3infoUrlTffd700}Ta5d6ff"

Tb4b4b4}

Te6edf3hwTb4b4b4.Te6edf3copyTb4b4b4(

Te6edf3requiresBootloaderUpgradeForOta Tff7b72= Te6edf3matchedQuirkTb4b4b4.Te6edf3requiresBootloaderUpgradeForOtaTb4b4b4,

Te6edf3bootloaderInfoUrl Tff7b72= Te6edf3matchedQuirkTb4b4b4.Te6edf3infoUrlTb4b4b4,

Tb4b4b4)

Tb4b4b4} Tff7b72else Tb4b4b4{

Te6edf3hw

Tb4b4b4}

T8b949e// If the device reported a specific build environment via pio_env, trust it for firmware retrieval

Te6edf3reportedTargetTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3withQuirkTb4b4b4.Te6edf3copyTb4b4b4(Te6edf3platformioTarget Tff7b72= Tffa657itTb4b4b4) Tb4b4b4} Tff7b72?: Te6edf3withQuirk

Tb4b4b4}

Tff7b72companion Tff7b72object Tb4b4b4{

Tff7b72private Tff7b72val Te6edf3CACHE_EXPIRATION_TIME_MS Tff7b72= Te6edf3TimeConstantsTb4b4b4.Te6edf3ONE_DAYTb4b4b4.Te6edf3inWholeMilliseconds

Tb4b4b4}

Tb4b4b4}